@workerdeck/ui 0.20.0 → 0.22.0

package/README.md

@@ -127,9 +127,10 @@ lose by forgetting a second mount isn't one.
   scoping — file an issue with your case.
 - Dark mode is driven **only** by `[data-theme='dark']` on the root element (the Tailwind
   `dark:` variant is remapped to it); `prefers-color-scheme` is not consulted at CSS level.
-- The session surface centers its content at `--wd-content-max-w` (default `48rem`).
+- The session surface centers its content at `--wd-transcript-max-width` (default `48rem`).
   Embedders in narrow docks (a VS Code bottom panel, a drawer) set it to `100%` for
-  edge-to-edge content. Every component also carries `data-slot` attributes for targeted
+  edge-to-edge content. Other geometry tokens: `--wd-status-bar-height`, `--wd-composer-padding`,
+  `--wd-transcript-row-gap`. Every component also carries `data-slot` attributes for targeted
   overrides — e.g. `[data-slot='composer-hint']` is the "Enter to send" line, which a host
   whose vertical space is precious can `display: none`.
 - `SessionPanel` can hand its dialog surfaces to the embedder: `panelSurface: 'external'`

package/build/{SessionPanel-CnU_IJ3-.d.mts → SessionPanel-13l25ubU.d.mts}

@@ -340,8 +340,21 @@ interface SessionPanelProps {
    * need a live closure at the far end. Same shape and same reason as
    * {@link SessionPanelProps.reveal}.
    *
-   * Hosts must clear their request on a session switch: a stale one replayed at
-   * remount would open a frame the new transcript cannot answer.
+   * **Withdrawing the request closes the frame.** The prop going away without a
+   * remount is itself a request — "the conversation, plainly" — and it leaves
+   * through the same path Back takes, so the reader lands on the Task row they
+   * came from. It has to mean that, because a host that keeps its request in
+   * route state (the dashboard's `?subagent=`) has exactly one way to say it:
+   * clear the search — which is what the sidebar's plain session click already
+   * navigated with, and what the browser's Back button re-arrives on. Before
+   * this, both were silently ignored and the frame outlived the address that
+   * claimed it was gone. Still not a controlled value: the panel enters and
+   * leaves frames on its own and *reports* through
+   * {@link SessionPanelProps.onSubagentChange}; only a **change** of the prop
+   * is a request.
+   *
+   * Hosts must still clear their request on a session switch: a stale one
+   * replayed at remount would open a frame the new transcript cannot answer.
    *
    * Claude-only in practice, and gated by data rather than by a flag — codex and
    * provider sessions have no `parentToolUseId`, so they grow no task blocks and
@@ -352,10 +365,34 @@ interface SessionPanelProps {
     nonce: number;
   };
   /**
-   * Terminal theme only: hold the prompt of the turn you are reading at the top
-   * of the transcript, as the Claude Code CLI does. The **real row** is pinned
-   * rather than a copy drawn above it, so it lines up with the rows beneath by
-   * construction — see `TranscriptRows`.
+   * Which sub-agent the panel now has framed, or `undefined` for the session's
+   * own conversation — the outward half of
+   * {@link SessionPanelProps.openSubagent}, and a *statement* where that one is
+   * a *request*. Deliberately not an echo: the panel enters frames the host
+   * never asked for (a Task row pressed in the transcript) and leaves them on
+   * its own (Back, Escape, a reveal), so a host that tracked only its own
+   * requests would be wrong within one click. No nonce, for the same reason —
+   * a state that arrives twice is the same state, where a request that arrives
+   * twice is two requests.
+   *
+   * Never fired for a fresh mount's initial `undefined`, and never fired from
+   * an unmount. The first would be a lie with consequences: the seeding effect
+   * consumes `openSubagent` in the same commit, so for one commit the state is
+   * `undefined` even though a frame is about to open, and a host folding
+   * reports into route state would clear the very `?subagent=` request the
+   * panel is in the middle of honouring. The second lets a panel keyed away on
+   * a session switch stomp what the host already believes about the next one.
+   * See the notify effect for the mechanics.
+   *
+   * What the sessions list's secondary selection feeds on: the row of the agent
+   * on screen takes the blue and its session's card steps back to grey.
+   */
+  onSubagentChange?: (toolUseId: string | undefined) => void;
+  /**
+   * Hold the prompt of the turn you are reading at the top of the transcript.
+   * Works in both variants: the terminal clips to one line (as the CLI does),
+   * cards shows a frosted bar. The **real row** is pinned rather than a copy
+   * drawn above it, so it lines up with the rows beneath by construction.
    */
   stickyPrompt?: boolean;
   /**
@@ -468,6 +505,12 @@ interface SessionPanelProps {
    * the client cannot see.
    */
   cacheTranscript?: boolean;
+  /**
+   * Replaces the default empty state when the transcript has no messages. Pass
+   * your product's own onboarding content instead of WorkerDeck's generic
+   * "`>_` Tell the agent what to do." placeholder.
+   */
+  emptyState?: ReactNode;
   className?: string;
 }
 /** What an embedder needs to *change* a session it doesn't own the attach for. */
@@ -518,6 +561,9 @@ type SessionVitals = {
    * as its "seen" watermark while the panel is actually on screen, and compares
    * against later to know what is new. */
   itemCount: number;
+  /** Session-cumulative cost in USD. The internal status bar renders this via
+   * `formatCost`; an external host needs it to reproduce that reading. */
+  totalCostUsd: number;
 };
 /**
  * The all-in-one embeddable session surface: status bar, streaming transcript,
@@ -546,6 +592,7 @@ declare function SessionPanel({
   scrubberMarks,
   reveal,
   openSubagent,
+  onSubagentChange,
   stickyPrompt,
   controlsSurface,
   onControls,
@@ -554,8 +601,9 @@ declare function SessionPanel({
   readOnly,
   toolHost,
   cacheTranscript,
+  emptyState,
   className
 }: SessionPanelProps): _$react.JSX.Element;
 //#endregion
 export { permissionModeChoices as C, PermissionModeSelectProps as S, useAffordances as _, SessionVitals as a, PermissionModeMeta as b, TranscriptDensityProvider as c, TranscriptVariantProvider as d, useTranscriptDensity as f, WithActions as g, TerminalAffordances as h, SessionSurfacePanel as i, TranscriptFont as l, CopyAction as m, SessionPanel as n, TerminalMetrics as o, useTranscriptVariant as p, SessionPanelProps as r, TranscriptDensity as s, SessionControls as t, TranscriptVariant as u, PERMISSION_MODES as v, permissionModeMeta as w, PermissionModeSelect as x, PermissionModeChoice as y };
-//# sourceMappingURL=SessionPanel-CnU_IJ3-.d.mts.map
+//# sourceMappingURL=SessionPanel-13l25ubU.d.mts.map